home *** CD-ROM | disk | FTP | other *** search
/ Carousel Volume 2 #1 / carousel.iso / mactosh / da / deskzap.sit / DeskZap 1.3 doc next >
Text File  |  1987-01-01  |  11KB  |  413 lines
  1. DeskZap version 1.3
  2.  
  3. by Bruce Tomlin
  4.  
  5. CIS: 72507,2742
  6.  
  7. GEnie:  BTOMLIN
  8.  
  9.  
  10.  
  11. DeskZap is a desk accessory which will let you perform many useful functions
  12. from anywhere you can use a desk accessory.
  13.  
  14.  
  15.  
  16. With DeskZap, you can:
  17.  
  18.   Ñ set the Finder information for a file (including the Protect bit)
  19.  
  20.   Ñ remove linefeeds, control characters, etc. from text files
  21.  
  22.   Ñ delete, rename, copy, and create files
  23.  
  24.   Ñ move files to different HFS folders
  25.  
  26.   Ñ create HFS folders
  27.  
  28.   Ñ close open files
  29.  
  30.  
  31.  
  32. About DeskZap 1.3╔
  33.  
  34. This is a shareware program. If you like it, and continue to use it, please
  35. send $15 to:
  36.  
  37.   Bruce Tomlin
  38.  
  39.   645 Weatherly
  40.  
  41.   San Antonio, TX 78239
  42.  
  43.  
  44.  
  45. Set file attributes╔
  46.  
  47. --------------------
  48.  
  49.   This will change the Finder information for a file.  You can change the
  50. Finder bits, the file's type and creator, and the information telling where
  51. the file's icon appears in its window.
  52.  
  53.   Note:  When using DeskZap under the Finder, if you try to change a file's
  54. attributes, and if either the file was created since the last time you were
  55. in the Finder, or you move the file's icon around, the attributes will revert
  56. to what they were before you entered the Finder.  (The exception to this is a
  57. file in a closed HFS folder.)  Because of this, if you create a file, you are
  58. immediately asked for the file's type and creator.  The default is a TEXT
  59. file for MDS EDIT.
  60.  
  61.   Note:  The "Protected" bit will only work if you have either the 64k ROMs
  62. or the 128k ROMs.  It will not work on MacWorks (Lisa/XL) or any future ROMs
  63. without the protect bit code being updated.  Why?  Because I  did direct
  64. calls to the ROMs in order to get the easiest and most reliable method of
  65. setting the protect bit.  If it won't work, the check box will be disabled,
  66. but it will still show whether the file is protected or not.
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. About the Finder bits:
  75.  
  76.  
  77.  
  78.        Bit         Meaning
  79.  
  80. Protected        The Finder will not copy a file with this bit set.  
  81.  
  82.                  This bit is used by most copy protected software.
  83.  
  84. File Locked      The file can't be written to.  This bit is set by the 
  85.  
  86.                  "Locked" check box in the "Get Info" windows of the newer 
  87.  
  88.                  (5.0 and later) Finders.
  89.  
  90. Locked           This bit is set by the "Locked" check box in all Finders.
  91.  
  92. Invisible        If this bit is set, the file will not appear in a Finder 
  93.  
  94.                  window or on the desktop.
  95.  
  96. Bundle           Set if the file contains icon information for the Finder.
  97.  
  98. System           If this bit is set, the Finder will not allow you to rename 
  99.  
  100.                  the file, and it will also mention that you are trying to 
  101.  
  102.                  delete a system file if you drag it into the trash.
  103.  
  104. Bozo             This bit is used by very early copy protections.  Finders 
  105.  
  106.                  before 5.0 will not allow you to copy a file with it set.
  107.  
  108. Busy             Used internally by the Finder
  109.  
  110. Changed          Used internally by the Finder
  111.  
  112. Inited           This bit is set if the Finder has given the file a place in 
  113.  
  114.                  a window or on the desktop.
  115.  
  116. Shared           Set if application is shared and is opened read-only  
  117.  
  118.                  (128K ROM only)
  119.  
  120. Cached           Set if file should be cached (not implemented)
  121.  
  122. Always Switch    If this bit is set, Finders 5.0 and later will always try to 
  123.  
  124.                  switch to the system on the disk containing the application   
  125.  
  126.                  when it is launched.
  127.  
  128. Never Switch     (not implemented)
  129.  
  130. Bit 3            Reserved, currently unused
  131.  
  132. Bit 2            Reserved, currently unused
  133.  
  134. Bit 1            Used internally by the Finder
  135.  
  136. On Desk          Set if file/folder is on the desktop (Finder 5.0 and later)
  137.  
  138.  
  139.  
  140.  
  141.  
  142. The following items will filter the contents of a text file into a new text
  143. file:
  144.  
  145.  
  146.  
  147. Strip linefeeds╔      All linefeeds are removed from the file.
  148.  
  149. Strip control chars╔  All control characters (except for carriage returns) 
  150.  
  151.                       are removed from the file.
  152.  
  153. Strip high bit╔       The high bit of each character in the file is removed.  
  154.                       (This can be useful for converting word processing 
  155.  
  156.                       files from other computers, such as WordStar files.)
  157.  
  158. Add linefeeds╔        Linefeeds are put after each carriage return character 
  159.  
  160.                       in the file.
  161.  
  162. Strip trailing blanks╔  All blanks at the end of a line are removed.  
  163.  
  164.                       (This can be useful with files created by MacTerminal.)
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Delete a file╔      
  171.  
  172. This will delete a file.
  173.  
  174.  
  175.  
  176. Rename a file╔
  177.  
  178.   This will rename a file, and will also move a file from one HFS folder to
  179. another. To move a file to a different folder, first select the file, then
  180. rename it to be in the destination folder.  Note that the file is moved
  181. before it is renamed.  If you try to move the file and rename it at the same
  182. time, and a file with the same name as the original file exists in the
  183. destination folder, then the file can't be moved.
  184.  
  185.   Note also that a file can't be renamed to another disk.  Copy the file
  186. instead.
  187.  
  188.  
  189.  
  190. Copy a file╔
  191.  
  192. ------------
  193.  
  194. This will copy a file, either onto the same disk, or onto another disk. All
  195. Finder bits are copied except for Inited, Protected, and File Locked.
  196.  
  197.  
  198.  
  199. Create a file╔
  200.  
  201. --------------
  202.  
  203. This will create a new file and ask you for the file type and creator.  The
  204. default name is "Empty File".
  205.  
  206.   
  207.  
  208. Create an HFS folder╔
  209.  
  210. ---------------------
  211.  
  212. This will create a new folder on an HFS disk.  Note that you can't create HFS
  213. folders on a non-HFS disk.  This results in an error code of -123, which
  214. means just that.
  215.  
  216.  
  217.  
  218. Delete resource fork╔
  219.  
  220. ---------------------
  221.  
  222. This will delete the resource fork of a file.  Be careful with 'Delete
  223. resource fork╔'.  It is intended to let you get rid of resource fork
  224. information in files (Mac Write, MDS Edit and Mac Terminal all have a
  225. resource fork in their documents) so that you can squeeze a bit more space
  226. out of a disk.  This may remove some information, such as Mac Terminal
  227. settings, or the tab settings in MDS Edit, so use this only when you don't
  228. need any such settings anymore.  This command will only let you mess with
  229. files that have both a data fork and a resource fork, so it will
  230. unfortunately let you select the System file (which has a data fork for
  231. system patches).  So, make sure that you know what you are doing when using
  232. this, and be careful, because this is quite permanent!  (Your only chance of
  233. recovery is to delete the file and use MacTools to recover it.)
  234.  
  235.  
  236.  
  237. Close an open file╔
  238.  
  239. -------------------
  240.  
  241. This will close a file which is currently open.  Be careful with 'Close an
  242. open file╔'!  If at all possible, throw the disk into the Trash (if it is not
  243. the current startup disk) or switch startup disks first and then throw the
  244. disk into the Trash.  (Shutting down your Mac will work too.)
  245.  
  246.   This is mostly useful for people who write applications which write to
  247. files, because, sometimes, a program under development may 'forget' to close
  248. a file, (or maybe the programmer forgot!) and the file is stuck open.
  249.  
  250.  
  251.  
  252. Close
  253.  
  254. -----
  255.  
  256. This closes DeskZap and removes it from the menu bar.
  257.  
  258.  
  259.  
  260.  
  261.  
  262. Some info:
  263.  
  264. ----------------
  265.  
  266. The commands will allow you to perform their functions repeatedly until you
  267. press the 'Cancel' button.
  268.  
  269.  
  270.  
  271. The newer Finders will recognize the renaming and deletion of files, but the
  272. older Finders (such as 1.1g) may have unpredictable results.  I run this
  273. under Finder 5.3 myself.
  274.  
  275.  
  276.  
  277. If you rename a file to the same name with some letters changed between upper
  278. and lower case, the Finder won't display this change on the screen unless you
  279. click on its icon.
  280.  
  281.  
  282.  
  283. If you are running under System 3.2, there is a bug in the system code which
  284. handles the Open and Save dialogs.  If there is any window on the screen
  285. needing to be updated (outside of the dialog), a newly inserted disk won't be
  286. recognized until you click on one of the items in the dialog.  Unfortunately,
  287. there is no way to work around this bug, so you'll just have to live with it
  288. until System 3.3 comes out.
  289.  
  290.  
  291.  
  292. In the future, I plan to write a companion desk accessory called 'DeskZap2'
  293. which will perform simple FEdit-type functions.
  294.  
  295.  
  296.  
  297. I'm interested in hearing any comments you may have.  (or <eek!> bug
  298. reports!)  Please tell me which version you have!  Also tell me where you got
  299. your copy of DeskZap (if you want to).
  300.  
  301.  
  302.  
  303. Please remember that this is a shareware program, so send in the $15 if you
  304. find this desk accessory useful.
  305.  
  306.  
  307.  
  308.  
  309.  
  310. Changes from version 1.1 to version 1.2:
  311.  
  312. ----------------------------------------
  313.  
  314. The speed of the file copy and file filter functions has been improved by
  315. trying to keep as much of the file in memory at one time as is possible.  On
  316. a ramdisk, it takes about 8 seconds to add linefeeds to a test file composed
  317. of 32767 carriage returns, as opposed to about 2 minutes in version 1.1.  I
  318. couldn't compare it with the original File Diddler program, which doesn't
  319. work at all with the 128k ROMs.  Also, disk swapping is reduced, making it
  320. bearable (hopefully) with only one disk drive.
  321.  
  322.  
  323.  
  324. A disk error which occured during the file filter functions would not be
  325. reported unless you pressed the 'Cancel' button after being asked for another
  326. file to process.  This has been fixed.
  327.  
  328.  
  329.  
  330. The dialog for 'Set file attributes╔' has been cleaned up a bit.
  331.  
  332.  
  333.  
  334. If you do not have HFS installed, 'Create HFS Folder╔' is disabled.
  335.  
  336.  
  337.  
  338. 'Delete resource fork╔' has been added.
  339.  
  340.  
  341.  
  342.  
  343.  
  344. Changes from version 1.2 to version 1.3:
  345.  
  346. ----------------------------------------
  347.  
  348. 'Set file attributes╔' now supports the File Locked bit and the newer Finder
  349. bits, and will now allow you to change the protect bit (unless you have a
  350. Lisa/XL or a set of ROMs which haven't been released yet).
  351.  
  352.  
  353.  
  354. I originally wasn't planning on supporting the protect bit because of the
  355. inherent problems with setting it, but I finally decided that if I kept the
  356. ROM specific code to one assembly language procedure and disabled it for
  357. unknown ROMs, it would be acceptable.
  358.  
  359.  
  360.  
  361. 'Strip Larry Loeb╔' was removed because some people thought it was silly.  It
  362. has been replaced with 'Strip trailing blanks╔'.
  363.  
  364.  
  365.  
  366. 'Copy a file╔' will now copy over the destination file if it already exists.
  367.  
  368.  
  369.  
  370. 'Rename a file╔' will now let you move a file into a different HFS folder.
  371.  
  372.  
  373.  
  374. 'Close an open file╔' will not let you close the System file or the current
  375. application.
  376.  
  377.  
  378.  
  379. The system error alert box code has been changed to describe the more common
  380. error messages.
  381.  
  382.  
  383.  
  384.  
  385.  
  386. About Larry Loeb:
  387.  
  388. -----------------
  389.  
  390. First, a word about File Diddler.  This program was written to perform the
  391. file stripper functions, but it didn't work with the new ROMs.  A friend
  392. pointed this out to me, I thought I could make a desk accessory out of it,
  393. and that's why I made DeskZap.
  394.  
  395.  
  396.  
  397. One of the things that was in File Diddler was "Strip Larry Loeb" which
  398. brought up a dialog with a window titled "La Bomba" and a message saying
  399. "Illegal or rude command!  ID=-4.5".
  400.  
  401.  
  402.  
  403. File Diddler was written by Scott Watson of Red Ryder fame, and Larry Loeb
  404. was one of his beta testers.  Therefore, it was intended as a little joke by
  405. Scott Watson.
  406.  
  407.  
  408.  
  409. I put it into my earlier versions of DeskZap because just because it was in
  410. File Diddler, but have now taken it out because some people have thought it
  411. was silly, and, besides, I've come up with something better anyway.  So, as Scott Watson would put it, that's the "inside poop".
  412.  
  413.